EmbeddedFrameUpdated

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODPart

EmbeddedFrameUpdated
The EmbeddedFrameUpdated method should update any of this part's link-source objects affected by a change to the specified embedded frame.
void EmbeddedFrameUpdated (in ODFrame frame,
                           in ODUpdateID change);
frame
A reference to an embedded frame whose content has changed.
change
The update ID associated with the frame.

DISCUSSION
An embedded frame's ContentUpdated method calls this method when its content changes. Your part's EmbeddedFrameUpdated method is called recursively for all containing parts in the frame hierarchy through the root part of the window displaying the embedded frame whose content has changed. Therefore, this part is not responsible for notifying its containing part of the change. This part may ignore the notification if it is uninterested in changes to embedded content.
If the embedded frame is involved in a link source with your part, your part's EmbeddedFrameUpdated method should update the link-source object with the new data.
Your part's EmbeddedFrameUpdated method may be called multiple times with the same update ID. However, your part should wait a certain length of time (perhaps, a second) before updating its display so that subsequent calls to your method (with the same update ID) do not result in multiple updates for the same change.

OVERRIDING
When you subclass ODPart, you can override this method if you want your part to do something special in response to the EmbeddedFrameUpdated notification. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely. This method needs to be implemented only by container parts.

EXCEPTIONS

kODErrCannotEmbed
This part does not support embedding.

SEE ALSO
The ODUpdateID type (page 917).
The ODFrame::ContentUpdated method (page 314).
Table 2-1 on page 89 in OpenDoc Programmer's Guide.
"Content Changes in Embedded Frames" on page 376 in OpenDoc Programmer's Guide.
"Updating a Link at the Source" on page 386 in OpenDoc Programmer's Guide.